home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / libs / pdcurs21 / readme.21 < prev    next >
Text File  |  1993-11-01  |  4KB  |  109 lines
  1.  
  2.                              PDCurses 2.1 (beta)
  3.                   (Public Domain Curses for DOS, OS/2 and UNIX)
  4.  
  5.  
  6. INTRODUCTION:
  7.  
  8.     The first thing that obviously needs mentioning is the title above.
  9.     The current code contains bug fixes for the DOS and OS/2 releases
  10.     and also includes an alpha release for Unix. The Unix release uses
  11.     another public domain package (mytinfo) to handle the low-level
  12.     screen writes. mytinfo was posted to comp.sources.unix (or misc) in
  13.     December 1992 or January 1993. Unless you are a glutton for punishment
  14.     I would recommend you avoid the Unix port at this stage.
  15.     
  16.     The other major addition to PDCurses is the support for DJGPP (the
  17.     DOS port of GNU C++). Thanks to David Nugent (davidn@csource.oz.au).
  18.     
  19.     Other additions are copywin() function, function debugging support
  20.     and getting the small and medium memory models to work.
  21.     The testcurs.c demo program has also been changed significantly and
  22.     a new demo program, tuidemo, has been added.
  23.     
  24.     Some people have suggested including information on where to get
  25.     dmake from. oak.oakland.edu in /pub/msdos/c
  26.     
  27. OTHER NOTES:
  28.     
  29.     Under DOS, by default, screen writes to a CGA monitor are done via
  30.     the video BIOS rather than by direct video memory writes. This is
  31.     due to the CGA "snow" problem. If you have a CGA monitor and do not
  32.     suffer from snow, you can compile private\_queryad.c with CGA_DIRECT
  33.     defined. This will then use cause PDCurses to write directly to the
  34.     CGA video memory.
  35.  
  36.     Function debugging: Firstly to get function debugging, you have to
  37.     compile the library with OPT=N in the makefile. This also turns on
  38.     compiler debugging. You can control when you want PDCurses to write
  39.     to the debug file (called trace in the current directory) by using
  40.     the functions traceon() and traceoff() in your program.
  41.  
  42.     Microsoft C 6.00 Users note:
  43.     ----------------------------
  44.     With the addition of several new functions, using dmake to compile 
  45.     PDCurses now causes the compiler to run "out of heap space in pass 2".
  46.     Using the 6.00AX version (DOS-Extended) to compile PDCurses fixes
  47.     this problem; hence the -EM switch.
  48.  
  49.     Functional changes
  50.     ------------------
  51.     A few curses functions have been fixed to exhibit their correct 
  52.     behaviour and make them more functionally portable with System V
  53.     curses.
  54.     The functions that have changed are overlay(), overwrite() and
  55.     typeahead.
  56.  
  57.     overlay() and overwrite()
  58.     Both of theses functions in PDCurses 2.0 allowed for one window to
  59.     be effectively placed on top of another, and the characters in the
  60.     first window were overlayed or overwritten starting at 0,0 in both
  61.     windows. This behaviour of these functions was not correct. These
  62.     functions only operate on windows that physically overlap with
  63.     respect to the displayed screen. To achieve the same functionality
  64.     as before, use the new function copywin(). See the manual page for
  65.     further details.
  66.  
  67.     typeahead()
  68.     This function in PDCurses 2.0 effectively checked to see if there
  69.     were any characters remaining in the keyboard buffer. This is not
  70.     the behaviour exhibited by System V curses. This function is intended
  71.     purely to set a flag so that curses can check while updating the
  72.     physical screen if any keyboard input is pending. To achieve the
  73.     same effect with typeahead() under PDCurses 2.1 the following code 
  74.     should be used.
  75.  
  76.     In place of...
  77.  
  78.         while(!typeahead(stdin))
  79.          {
  80.             /* do something until any key is pressed... */
  81.          }
  82.  
  83.     use...
  84.  
  85.         nodelay(stdscr,TRUE); /* getch() to return ERR if no key pending */
  86.         while(getch() == (ERR))
  87.          {
  88.             /* do something until any key is pressed... */
  89.          }
  90.  
  91.  
  92. ACKNOWLEGEMENTS: (in no particlar order)
  93.  
  94.     Jason Shumate,Pieter Kunst,David Nugent,Andreas Otte,
  95.     Pasi Hamalainen,James McLennan,Duane Paulson,Ib Hojme
  96.     
  97.     Apologies to anyone I may have left out.
  98.  
  99.  
  100. Cheers, Mark
  101.  
  102. ------------------------------------------------------------------------
  103. Mark Hessling                          email: M.Hessling@gu.edu.au
  104. DBA, ITS                               phone: + 61 7 875 7691
  105. Griffith University                    fax:   + 61 7 875 7787
  106. Nathan 4111
  107. Qld Australia                          *** PDCurses maintainer ***
  108. ------------------------------------------------------------------------
  109.